UiPath connector

Overview

UiPath provides an API that exposes several actions that let you take control of your resources in the orchestrator. Bizagi has created in the RPA life cycle management project a connector that uses the UiPath API. This section explains how you configure your connector, and how you can use it in other projects.

Note:
You can use this connector with cloud-based licensed UiPath orchestrators. Trials, non-licensed and on-premises versions cannot be integrated using the connector of this project.

In Bizagi Studio, open the Expert view. Select the External Systems module to find a UiPath connector:

Right-click the connector to display the context menu and select Properties:

Here you can set the following global parameters:

• Orchestrator URL: URL of your UiPath orchestrator.
• Tenant: Name of the tenant where you have your UiPath infrastructure.
• User name: Name of the super admin user of the orchestrator.
• Password: Password of the orchestrator user.

When you are ready, click OK to save your settings.

In processes that need to invoke the connector, there are services tasks with a configuration for the connector, depending on the method needed. For example, when you create a new machine, Bizagi uses this connector to register this machine in your UiPath orchestrator:

When you open the configuration of the service task, it invokes an action included in the connector. This example uses the Add machine action:

Each action has some inputs depending on the action type. However, each action also includes the orchestrator parameters:

• Orchestrator URL
• Tenant
• User name
• Password

Because you can have multiple orchestrators or tenants in the same project, you can send these parameters in the invocation of the connector in each process. When you map these parameters in the action configuration, Bizagi overrides the global configuration of the connector.

Note:
When you use the connector, you can send it different orchestrator, tenant or user credentials than those in the global configuration. In that case, the information sent in the mapping configuration is considered before the global configuration.

Connector Actions

The connector includes several actions that cover most of the methods exposed by the UiPath API. You can edit the connector if you need to make changes to its logic, or if you need to include more methods. See download the connector. The following table contains the most important methods used by the RPA life cycle management project:

Action	Description
Add environment	Create a new environment in UiPath within the tenant of an orchestrator.
Add machine	Create a new machine in UiPath within the tenant of an orchestrator.
Add robot to environment	Associate an existing robot with an environment. You need to send the ID of the Robot.
Create robot	Create a new robot in UiPath.
Create an asset	Register a new asset in UiPath that a robot can use.
Delete asset	Delete an existing asset.
Delete environment	Delete an existing environment. You need to send the ID of the environment.
Delete machine	Delete an existing machine. You need to send the ID of the machine.
Delete robot	Delete an existing robot. You need to send the ID of the robot.
Get environments	Get all the environments associated with a tenant in a UiPath orchestrator.
Get machines	Get all the machines in the orchestrator, or based on filter conditions. For example, get information about a machine with a specific name.
Upload package	Uploads the development package created in UIPath studio in an orchestrator.

Download the connector

If you want to make changes to the connector, or see how it is built, you can download the connector and review it in the connector editor. Select a version and then you can download the connector clicking the Export connector package button:

Upload the connector in the connector editor, and then you can review each method code and configuration: